home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / tbduse30.zip / TBDUSE.DOC < prev    next >
Text File  |  1992-09-13  |  10KB  |  225 lines
  1.            TriBBS Door Use Bulletin Generator v3.0
  2.             (c) 1991-1992 E.L. Morrow
  3.                written in  Turbo Pascal  6.0
  4.                  For TriBBS v3.x 
  5.  
  6.                    -by-
  7.  
  8.                 E.L. Morrow
  9.  
  10.                911 N. Pacific Ave #15
  11.                Crescent City, Ca 95531
  12.                Voice: (707) 465-6765
  13.  
  14.  
  15.   DISCLAIMER:   
  16.     I relinquish any and all responsibility for anything that may
  17.   occur due to the use of this program, correctly or incorrectly.  I am
  18.   in no way libel for any damage that is attributed to the use of this
  19.   program by any and all persons.
  20.  
  21.  
  22.   SHAREWARE:
  23.     TriBBS Door Use Bulletin Generator is ShareWare.  It's not crippled 
  24.   or anything, but it does let your users know that it isn't registered by
  25.   showing #UNREGISTERED# at the top of the header on the display screens.
  26.   
  27.     Registration is only $8 for this  new  version.  Future upgrades
  28.   will be priced accordingly depending on how much is changed and added.
  29.   Anyone who registers now will never have to pay for another registration
  30.   of this program.  Your registration number will be good for all versions.
  31.  
  32.     Distribution of this program will be solely the province of the
  33.   large number of BBS's across the country.  I can't afford to send disks
  34.   out to people who register.  I know this sounds kind of crude, but if
  35.   you enclose your BBS number when you register along with a password to
  36.   get on your system, I'll upload the latest version (if it's different) 
  37.   and send you a private message in an appropriate conference that will
  38.   list your registration information (just a reg number and name actually).
  39.  
  40.     Print and fill out the form in this archive called TBDUSE.REG
  41.   and mail it to:
  42.             Elm L. Morrow
  43.             911 N. Pacific Ave Apt 15
  44.             Crescent City, CA 95531
  45.  
  46.     Make checks or money orders payable to: Elm L. Morrow
  47.  
  48.   FIRST TIME SETUP:
  49.  
  50.     Setting up the Bulletin Generator is easy.  The first thing you 
  51.   need to do is set up the config files.  They don't *have* to be called
  52.   TBDUSE.1, TBDUSE.2, etc... , but it maintains clarity and ease
  53.   of use if they are.  They take this form:
  54.  
  55.     Nocturnal Communication         {Name of BBS}
  56.     0                               {Registration Number}
  57.     C:\TRIBBS                       {Main Node directory}
  58.     C:\TRIBBS                       {Node Directory}
  59.     drbull2                         {Name of bulletin}
  60.     90                              {Max. Security Level}
  61.     7                               {Days of inactivity}
  62.     15                              {Days before deletion}
  63.  
  64.     Line 1:         Name of BBS
  65.         This is the name that you are going to register this
  66.         utility under, preferably the name of your BBS.
  67.         NOTE: Case *is* important once you get your number.
  68.  
  69.     Line 2:         Registration Number
  70.         This is where you'll put your number after you rush to
  71.         send me $8 to register this fine revision! <grin>
  72.  
  73.     Line 3:         Main BBS directory
  74.         The Main TriBBS directory, specifically the one that
  75.         contains SYSDAT1.DAT.
  76.  
  77.     Line 4:         Main node directory
  78.         The current node's main directory.  Specifically the
  79.         directory that contains this nodes SYSDAT2.DAT and
  80.         NODE.DAT files.
  81.  
  82.     Line 5:         bulletin name (no extension)
  83.         The name that will be used for this bulletin.  Do *NOT*
  84.         include a path or extension, just the base name.  The
  85.         Generator will check out your node configuration to 
  86.         determine which directory the bulletins should be put
  87.         in.
  88.  
  89.     Line 6:         Security Level limit
  90.         The Maximum security level of a door (or menu option
  91.         door) that will be shown on the bulletins.
  92.  
  93.     Line 7:         Days of inactivity before a warning
  94.         *NEW FEATURE*  After this number of days has gone
  95.         by without anyone using the door, it will have an
  96.         ***OLD*** tag placed in the Avg. Time column.
  97.  
  98.     Line 8:         Days of inactivity before removal
  99.         *NEW FEATURE*  After *this* number of days has gone
  100.         by with no activity, the Generator will put the word
  101.         <deleted> in the name field and the next new door you
  102.         install will take over its slot.
  103.  
  104.  
  105.   RUNNING THE GENERATOR:
  106.  
  107.     The Door Use Bulletin Generator goes in your BETWEEN.BAT.  Just add
  108.   the following lines before the last line that calls BOARD.BAT:
  109.  
  110.         cd c:\tribbs\utils\tbduse
  111.         tbduse tbduse.1
  112.         cd c:\tribbs
  113.  
  114.     This assumed that you have placed the .EXE and config files in a
  115.   directory called C:\TRIBBS\UTILS\TBDUSE.  If you have not, change the
  116.   CHDIR commands to the correct paths and you'll be fine!
  117.  
  118.   GENERAL INFORMATION:
  119.  
  120.     In this new version, the Door Use Bulletin Generator will store
  121.   all information on doors in its own data file called TBDUSE.DAT.  If you
  122.   want to start over, just erase this file.  Erasing the bulletins 
  123.   themselves will accomplish nothing...the next time you run the program
  124.   it will create a new set with the exact same information (plus any
  125.   door use in the last logon) as the files you deleted.
  126.  
  127.     I've decided to continue with this utility indefinately.  Now that
  128.   I've rewritten it, I like it very much!  The original version was nothing
  129.   but a kludge and I never had much in the way of paternal instinct for it.
  130.   This new version shows much promise, however.  The code is clean and it
  131.   runs very well.  It only took me a few hours to program it (about 8) from
  132.   scratch.  I just erased the old source code and started from the bottom
  133.   up.
  134.  
  135.     I removed the REPORT option because I didn't think it was being
  136.   used by anyone.  If this is incorrect, please let me know if you would
  137.   like it to be put back.  Be serious, though...if you really do use it,
  138.   tell me so and I will definately restore it.  It was an ugly report
  139.   anyway, and I don't think it was tracking the information correctly.
  140.  
  141.     In place of the REPORT/NOREPORT option, however, I did add a new
  142.   set of options that allow you to specify how long a door will be listed
  143.   on your bulletins after it has fallen into disuse.  If you remove a door
  144.   or just no one's using it, this will first list an ***OLD*** warning on
  145.   the bulletin, then it will remove the entry entirely.  When this happens
  146.   you may see an entry for <deleted> on the bulletin for a while.  It will
  147.   go away the first time a new door is run.
  148.  
  149.     Another new feature to the Generator is that it will now pick up
  150.   the doors that are run from the other menus.  When I first updated the
  151.   Generator, these doors were not posted to the CALLERS.LOG and so I had
  152.   no way of tracking them.  Unexpectedly <grin>, they began posting after
  153.   a later version, but with the path and name of the batch file they ran!
  154.   The Generator now looks up the menu file that corresponds to the entry
  155.   and plucks the correct door title from it.  Hopefully this method of
  156.   posting doors run from menus does not change again or I will have to
  157.   redo the lookup routines again in order for it work correctly.  BTW,
  158.   LOGON.BAT will not post to the bulletins, and neither should security
  159.   specific logon batch files.
  160.  
  161.     It is very IMPORTANT that you give the doors the same title if they
  162.   are run from more than one place.  For instance, say you have TriMail on
  163.   the Doors Menu as well as on the Message Menu.  If the title is not the
  164.   exact same, character by character (up to 37 char's), it will have two
  165.   entries on the board.
  166.  
  167.  
  168.   SUGGESTIONS, FUTURE STUFF, ETC...:
  169.  
  170.     Please leave your suggestions for improvements and any other 
  171.   comments on the following board:
  172.  
  173.     The White Hat
  174.     Sysop: T.J. Steele
  175.     (707) 465-5456
  176.               or
  177.         Wheel Chair Express
  178.         SysOp: Dan Schiffner
  179.         (707) 464-3705
  180.         (707) 465-1272
  181.  
  182.     Conference:  Nocturnal Support
  183.  
  184.  
  185.     Of course, there's always snail mail.  As a general rule, I don't
  186.   like answering letters, but if you send a check or m.o. for $8 with a
  187.   letter, I'll more than likely get in touch with you one way or the other.
  188.  
  189.     Remember, if I don't get any registrations, I won't update this
  190.   program any more.  Many of you thought I had dropped out of the game,
  191.   but I was only taking a vacation <grin>.  I had been coding like a madman
  192.   to keep up with Mark and the bug reports/wish lists and it took quite
  193.   a bit out of me.  I'm pacing myself a little more these days (yeah, right!)
  194.   so I can stick with it.  So far, though, registrations have been pretty
  195.   pitiful as a whole.  Considering that TriBBS has broken 200 registrations
  196.   since this .DOC was updated, I think it's a real shame that the best I've
  197.   been able to do is about a dozen reg's for any given util/door.
  198.  
  199.     I've been working on expanding my ShareWare base and, basically,
  200.   moving away from writing just for TriBBS because of this. I have several
  201.   Windows titles close to ready for release and I've joined a programming
  202.   team called The Creative Block that just started up and man have we got
  203.   a surprise for you door gamers!!!
  204.  
  205.     If I've missed something or you can't make sense out of all or part
  206.   of this .DOC file, get in touch and let me know.  It's really not that
  207.   hard to get it set up, but I don't always feel like writing and so the
  208.   descriptions of how to do things get erratic and confusing.  <Sigh>
  209.  
  210.  
  211.  
  212.   HISTORY:
  213.     Version 1.x
  214.         Ran w/ TriBBS 1.x
  215.     Version 2.x
  216.         Ran w/ TriBBS 2.x
  217.  
  218.     Version 3.0
  219.         This new version has been recoded to work with the
  220.     changes in TriBBS v3.x.  The entire program has been rewritten
  221.     from scratch, so the previous history makes little or no 
  222.     difference.  The util now maintains its own data file and creates
  223.     the bulletins from this file.
  224.  
  225.